home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / qrt.lzh / raw2spec.txt < prev    next >
Text File  |  1985-11-19  |  6KB  |  124 lines
  1. ==============================================================================
  2.   Raw2Spec Version 1.0                                      August 3rd, 1991
  3.   Robert Barnhardt                                (C) 1991 Brain~Waves Group
  4. ==============================================================================
  5.  
  6.  Raw2Spec is Copyright 1991 by Robert Barnhardt.  You may use and distribute
  7.  the program and its accompanying documentation, as long as they are retained
  8.  intact, unmodified, and unmolested.
  9.  
  10.  
  11.  
  12.  General Information
  13.  """"""""""""""""""""
  14.  Raw2Spec is a post-processor for use with the QRT/ST ray tracing system.  It
  15.  converts the RAW output of  QRT/ST into Spectrum 512 format,  for display on
  16.  any Atari ST system that can display Spectrum pictures (what a coincidence).
  17.  Raw2Spec works in any resolution; however, the Spectrum preview is obviously
  18.  not available in monochrome.
  19.  
  20.  
  21.  Raw2Spec Usage
  22.  """""""""""""""
  23.  
  24.  1. Render an image with QRT/ST.
  25.  
  26.  2. Execute Raw2Spec from the Desktop.
  27.  
  28.  3. Ignore the cheap alert box title screen.
  29.  
  30.  4. Select a RAW file to convert (such as the one you just created).
  31.  
  32.  5. Do you want dithering?  Dithering involves using algorithms to render
  33.     the RAW file with more accuracy than normal.  I suggest you try using
  34.     dithering, and if the results don't please you, try again with none.
  35.  
  36.  6. If so, what sort?  The selections, from least to most advanced, are
  37.     'Simple' (one pattern), '4 x 4' (a 4x4 ordered dither), and 'Error'
  38.     (error dispersion, with Floyd/Steinberg filter).  A good idea is to
  39.     start with the most sophisticated, 'Error', and fall back to the
  40.     lesser methods if you are not pleased with the results.
  41.  
  42.  7. Use register 15?  Spectrum 512 uses register 15 as its current drawing
  43.     colour, and any images that you wish to load into Spectrum 512 can NOT
  44.     use register 15.  However, if you're only going to be viewing the
  45.     pictures, there's no reason why you shouldn't use it (and gain a few
  46.     extra colours in your image).
  47.  
  48.  8. The picture will now be converted, at a fairly fast rate (~ 30 seconds
  49.     for a full 320 x 200 image).  If your image is greater than 320 x 200
  50.     in size, it will be cropped (not shrunk).
  51.  
  52.  9. You will now get a preview of the picture (if you're not in monochrome).
  53.     Hit any key to exit the preview.
  54.  
  55. 10. If you're not in monochrome, you'll be asked if you you wish to save
  56.     the picture.  'No' will take you back to the first file selector,
  57.     and 'Again' will take you back to the first 'Dithering?' alert box
  58.     (and will use the same input file).
  59.  
  60. 11. If you selected 'Yes', you'll now specify where to save the Spectrum
  61.     picture (as an uncompressed SPU file).  Swapping disks is kosher.  If
  62.     you click on 'Cancel', you will be taken to the 'Save this picture?'
  63.     alert, even if you're in monochrome.  After the file is saved, you
  64.     will be taken back to the initial file selector, where you may choose
  65.     another file to convert, or exit the program by clicking 'Cancel'.
  66.  
  67.  
  68.  Technical Notes
  69.  """"""""""""""""
  70.  
  71.  o  Raw2Spec was written in 100% assembly, with AssemPro from Abacus
  72.     Software.
  73.  
  74.  o  The input image is currently cropped (top left corner), if it is
  75.     larger than 320 x 200.  If another version is released, it will
  76.     allow shrinking by pixel averaging as an option.
  77.  
  78.  o  Dithering is used to reduce the input file, one scanline at a time,
  79.     into the range of 512 colours.  The colours are then sorted by
  80.     popularity (frequency of occurance), and added to the palette in the
  81.     order of most to least popular;  if a colour cannot be added, the
  82.     closest match is calculated by finding the least square to each
  83.     available colour.  Finally, the scanline is plotted (this could be
  84.     done while setting the palettes, but using a strict left to right
  85.     plot routine is faster in the long run).
  86.  
  87.  o  The converter doesn't save in SPS format because SPS doesn't allow
  88.     for the use of register 15.  I'm not sure of SPC format yet.  If ever
  89.     I release another version of Raw2Spec, it will be able to save in all
  90.     three (SPU, SPC, SPS) formats.
  91.  
  92.  
  93.  An Explanation (not An Apology)
  94.  """"""""""""""""""""""""""""""""
  95.  
  96.  To those who have written to me in the past:  I have not forgotten you.
  97.  I did, however, temporarily abandon you in favour of something that's
  98.  slightly more important to me - education.  I had been spending a
  99.  totally ridiculous amount of time on this computer, and when the power
  100.  supply went, I had a wonderful excuse to get back to the school work
  101.  I'd been neglecting.  I've just graduated grade 13, and will hopefully
  102.  be attending a university (a cheap one) in a year or so.  In the mean-
  103.  time, I'll try to complete the projects that I said I'd do for you,
  104.  barring any further technical difficulties; I'm not spending another
  105.  dime on this antique.
  106.  
  107. { The next week... For a good laugh, read the post-script to the QRT_ST
  108.       documentation.  Next time, I'll remember to knock on wood.        }
  109.  
  110.  
  111.  Bugs, Comments, Lawsuits
  112.  """""""""""""""""""""""""
  113.  
  114.  Get in touch.  You can contact me on CompuServe at user # 73707,533
  115.  (I am not a number, I am a free man) or on GEnie as R.BARNHARDT1 (how
  116.  original).  If you're one of the few living people able to communicate
  117.  by non-electronic means, write me at the following address:
  118.  
  119.                                                    Robert Barnhardt
  120.                                                    869 Garrison Road
  121.                                                    Fort Erie, Ontario
  122.                                                    CANADA     L2A 1N6
  123.